Microsoft Teams

The DRUID ChatBot Portal allows you to create the bot once and deploy it in MS Teams.

Prerequisites

  • You built and published a DRUID chat bot.
  • You have a MS Teams account.
Note:  MS Teams channel integration is not available in DRUID on premise deployments; you cannot activate the channel.

This section describes how to integrate DRUID chatbots with MS Teams using the Developer Portal. For information on other options you’ve got for MS Teams integration, see Microsoft documentation.

Step 1. Active MS Teams channel in DRUID

  1. Log in the DRUID Chatbot Portal and from the main menu, select your bot. The bot configuration page appears by default on the Details tab.
  2. Click the Channels tab, and then click Teams. The Teams Channel Info section expands.
  3. Activate the Teams channel. To do so, select the Microsoft Teams option that suits your company's Microsoft Office 365 version, agree to the Microsoft terms and statements and click the Publish button.

    4. The channel activation might take up to 1 minute. When the channel activation completes, the Microsoft Application Id field is automatically filled in. This is the MS Azure ID associated to your DRUID chatbot. Copy it using the copy icon () as you will need the value at the next step.

    After the channel’s activation, the following fields are available in DRUID:

    • [[ChatUser]].ChannelId = "msteams"
    • [[ChatUser]].UserId - Stores an unique identifier of the MS Teams user account.
  4. Click the Save & Close button.

Step 2. Create a bot using Developer Portal and download the app package

  1. In the Teams client, open the Developer Portal. From the ... overflow menu on the left, click Developer Portal.

    2. The app opens.

    If Developer Portal isn't already installed, install it:

    1. Search for Developer Portal.
    2. Click on Developer Portal.

      3. The app is now available when clicking … on the left menu.

  2. Click the Apps tab, then click New app.

  3. Type a name for your app and click Add.

    4. The Edit app page appears which walks you through the steps you need to complete in order to distribute your chatbot.

  4. Provide your app details (mandatory fields marked with an asterix).

    5. In the Microsoft Partner Network ID field, enter the DRUID MPN (the one generated in DRUID after the channel activation).

  5. Click Save.
  6. From the Configure left menu, click Permissions and under Device Permissions, select Send the user notifications.

  7. Click Save.
  8. From the Configure menu, click App features and on the right pane, click Bot.
  9. Tap on Enter a bot ID and in the field below enter the Microsoft Application ID associated to your DRUID chatbot (the one generated in DRUID after the channel activation).
    10. Hint:  Copy and Paste the Microsoft Application Id from the DRUID Bot Settings > Channels > Teams.

  10. Select the capabilities and scopes your bot will need: Upload and download files, scopes Personal and Team.

  11. Scroll down and click Save.
  12. If you want your bot to benefit the sensitive data manipulation:
    1. On the Configure menu, click Domains.
    2. Add the following domains:
      • token.botframework.com
      • DRUID API domain that is specific to the DRUID Cloud you're using:
        • DRUID Community PROD Europe PROD US PROD Australia
        druidapi.comm.eu.druidplatform.com prod-DRUID-api.azurewebsites.net druidapi.us.druidplatform.com druidapi.au.druidplatform.com
  13. At the top right corner of the page, click the Publish button. A pop-up appears.

  14. Click Download the app package.

The app package is successfully downloaded in your default download folder.

Step 3. Validate your app package manifest

Go to Microsoft app validation, upload your app package (the one you downloaded at Step 2. When you validate your app, you'll get a list of all missing, required assets. Make sure that you add missing assets until the app passes the validation.

Note:  You can also validate your app package manifest directly in the Developer Portal; to do so, on the main menu, click Overview.

Step 4. Install the DRUID chatbot in MS Teams

Note:  You must be the owner of the MS Team in order to install the DRUID chatbot.
Important!  

The bot installation in MS Teams is done progressively (not instantly); so it might take up to 48 hours for the installation to complete depending on how many MS Team members you have.

During the bot installation, the bot appears to your Team members on the left menu and sends them the welcome message set on the bot. If you want to prevent the bot from sending the welcome message until its installation in MS Teams completes, temporarily disable the Welcome flow (in DRUID Portal, go to the bot details, section Dialogue management and leave the Welcome flow field empty).

To integrate the DRUID chatbot in a MS team, in MS teams, from the left menu, click Teams. Right click on a team that you created and select Manage team.

The Team page appears by default on the Members tab.

Click the Apps tab, then at the bottom-right corner of the page, click Upload a custom app.

Browse for the app package you downloaded at Step 2, select it and click Open. If the Microsoft manifest passed, the DRUID chatbot installation starts in the selected team.

Step 5. Talk to your bot

To open the chatbot in the MS Teams channel, in the DRUID Portal, go to the bot settings, click the Channels tab and click on the Teams channel icon. You can start talking to the bot.

Note:   For DRUID version 1.63 and higher, the MS Teams channel supports sensitive data input. For more information, see Prompt Steps.

Limitations

MS Teams has a limited pagination for hero cards and buttons with repeater, as follows:

  • For hero buttons with repeater, a bulk of 6 will be shown per page.
  • For hero cards with repeater, a bulk of 9 will be shown per page.
Related Topics Link IconRelated Topics